home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / kzipv0_9.zip / KZipper.txt < prev   
Text File  |  1996-06-26  |  5KB  |  128 lines
  1.                                   KZipper V0.9
  2.                                   ------------
  3. (c) Copyright 1996 Kevin Ash
  4.     e-mail[ valid until June '97 ]:     k.a.ash@newcastle.ac.uk
  5.     snail mail: see end of document
  6.  
  7. For updates and other software I've coded check out[ valid until June '97 ].
  8.     http://www.ncl.ac.uk//~n4050728/os2/
  9.  
  10. Description: A pm utility for making zipfile management easier.
  11.  
  12.  
  13. Files:
  14. ------
  15.     KZipper.exe            -   main executable
  16.     KZipper.txt
  17.     install.cmd
  18.     res_dll/FILE.ICO        \
  19.     res_dll/FILE_X.ICO      |
  20.     res_dll/FOLDER.ICO      |   These files are only needed if you want to
  21.     res_dll/FOLDER2.ICO     |   customize the menu's text or modify the icons
  22.     res_dll/KZIP.ICO       |   used to represent the files/folder, etc
  23.     res_dll/KZipDll.c      |      Please read KZipdll.txt before creating a
  24.     res_dll/KZipDll.def    |   custom resource dll.
  25.     res_dll/KZipDll.obj    |
  26.     res_dll/KZipDll.rc     |
  27.     res_dll/KZipDll.txt    |
  28.     res_dll/KZipper.ids    |
  29.     res_dll/KZipper.rc     |
  30.     res_dll/resource.cmd    |
  31.     res_dll/volume.ICO      |
  32.     res_dll/ZIPFILE.ICO     /
  33.     res_dll/KZipPK.dll     - ready made resource dll - for pkunzip compat( see below)
  34.  
  35. Installation:
  36. -------------
  37.  
  38.     Running the install.cmd script in most cases is sufficient, however you may wish
  39. to copy KZipper.exe to somewhere on your path so it can be run from command prompts
  40. easily.
  41.     The install script creates a KZipper object on the desktop.
  42.  
  43. By default this program use Info-zip unzip.exe to extract files.
  44.  
  45.     If you want to use pkunzip.exe you'll also have to rename KZipPK.dll to KZipper.dll
  46. and put this file somewhere in your LIBPATH( in most case's the same directory as
  47. the executable will do ).
  48.  
  49. Usage:
  50. ------
  51.  
  52. either:-
  53.  
  54.   1) Double click the KZipper icon to start the program
  55.   2) From a zipfile object choose the open menu and select KZipper
  56.      ( This in alot of case is the same as doble clicking the zipfile object ).
  57.  
  58. In both cases if the file is an invalid archive a File Dialog will be presented to allow
  59. you to choose another file.
  60.  
  61. You can then drag 'n' drop files in and out of the archive( just like you would with normal
  62. WPS objects).
  63.  
  64. Notes:
  65.     1) WARNING: dragging a file into an archive currently always updates the file
  66.         (even if the file in the archive is neser ).
  67.  
  68.     2) If you drag a file out of an archive and a file with that name already exists,
  69.         the file will be renamed( automatically) however the name in the WPS folder
  70.         remains the same( I thought this was because it was using the .LONGNAME ea
  71.         so I added the code to rename the .LONGNAME ea and this didn't solve the problem,
  72.         if you know how to solve this, please let me know how ).
  73.  
  74.     3) The font & colours may be changed by drag 'n' drop( The scheme pallete is not fully
  75.         implemented)
  76.  
  77.     4) The zip code is built into the program and I use the deflation method( and thanks
  78.         must go to Jean-loup Gailly and Mark Adler for this as I used there excelent
  79.         zlib general compression library( version 1.0.1), thanks also to
  80.         Kai Uwe Rommel - for EA code( from Info-Zip's zip source files).
  81.         I got the general format of the zipfile from APPNOTE.TXT( found in PKZ204G.ZIP).
  82.  
  83.     5) I use unzip to extract the files( I was going to build it into the code until
  84.         I looked at the source files and realised how much work there would be).
  85.        In the next version of this I may use the unzip.dll( so i can have more control over
  86.        the extraction).
  87.  
  88.     6)  Sorry, this program can't extract files that are encrypted.
  89.  
  90.     7)  As I have no books on Drag 'n' Drop I'm not 100% sure this code is correct
  91.         ( in particular the rendering mechanism's )
  92.  
  93.     8) If you have a lot of files to compress/extract I would still recommend using unzip/zip
  94.         as this will be far quicker( in general).
  95.  
  96.     9)  I write all settings into KZipPER.INI( mainly as it annoys me how programs write
  97.         load of stuff into the OS2.INI file even if I just run them the once).
  98. TODO
  99. ----
  100.     1) rename/replace when adding/extracting files from an archive.
  101.     2) renaming of archive entries
  102.     3) allowing dragging between different windows of the same archive
  103.     4) at the moment when the archive is changed all containers are emptied and refilled
  104.         when really I only need to change the records that have changed.
  105.     5) Full wps integration - but as i don't have a som compiler this isn't likely to happen
  106.         ( unless I win the lottery )
  107.  
  108. Getting in Touch
  109. ----------------
  110.  
  111.     If you use this program and like it, let me know by sending an e-mail message to
  112. the address at the top of the document or better still send a postcard to:-
  113.  
  114.          41 Abbot Court, Gateshead, Tyne & Wear, NE8 3JY, ENGLAND.
  115.  
  116.     If you don't like this program, discover any bugs or have any suggestions, please let
  117. me know why or what they are by e-mailing a message to the address at the top of the
  118. document.
  119.  
  120. Legal Stuff
  121. -----------
  122. KZipper is Copyright 1996 by Kevin Ash.
  123.  
  124. KZipper is distributed in the hope that it will be useful, but with
  125. ABSOLUTELY NO WARRANTY; without even the implied warranty of MERCHANTABILITY
  126. or FITNESS FOR A PARTICULAR PURPOSE.
  127.  
  128.